package cn.iocoder.lw.module.core.service.evaluation;

import cn.iocoder.lw.framework.common.pojo.PageResult;
import cn.iocoder.lw.module.core.controller.admin.evaluation.vo.evaluation.CoreWorkOrderEvaluationPageReqVO;
import cn.iocoder.lw.module.core.controller.admin.evaluation.vo.evaluation.CoreWorkOrderEvaluationSaveReqVO;
import cn.iocoder.lw.module.core.controller.app.evaluation.vo.evaluation.AppCoreWorkOrderEvaluationCreateReqVO;
import cn.iocoder.lw.module.core.controller.app.evaluation.vo.evaluation.AppCoreWorkOrderEvaluationUpdateReqVO;
import cn.iocoder.lw.module.core.dal.dataobject.evaluation.CoreWorkOrderEvaluationDO;

import jakarta.validation.Valid;
import java.util.List;
import java.util.Map;

/**
 * 工单评价 Service 接口
 *
 * @author Lw源码
 */
public interface CoreWorkOrderEvaluationService {

    /**
     * 创建工单评价
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createEvaluation(@Valid CoreWorkOrderEvaluationSaveReqVO createReqVO);

    /**
     * 创建工单评价(APP端)
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createEvaluationApp(@Valid AppCoreWorkOrderEvaluationCreateReqVO createReqVO);

    /**
     * 更新工单评价
     *
     * @param updateReqVO 更新信息
     */
    void updateEvaluation(@Valid CoreWorkOrderEvaluationSaveReqVO updateReqVO);

    /**
     * 更新工单评价(APP端)
     *
     * @param updateReqVO 更新信息
     */
    void updateEvaluationApp(@Valid AppCoreWorkOrderEvaluationUpdateReqVO updateReqVO);

    /**
     * 删除工单评价
     *
     * @param id 编号
     */
    void deleteEvaluation(Long id);

    /**
     * 获得工单评价
     *
     * @param id 编号
     * @return 工单评价
     */
    CoreWorkOrderEvaluationDO getEvaluation(Long id);

    /**
     * 获得工单评价分页
     *
     * @param pageReqVO 分页查询
     * @return 工单评价分页
     */
    PageResult<CoreWorkOrderEvaluationDO> getEvaluationPage(CoreWorkOrderEvaluationPageReqVO pageReqVO);

    /**
     * 校验工单评价存在
     *
     * @param id 编号
     * @return 工单评价
     */
    CoreWorkOrderEvaluationDO validateEvaluationExists(Long id);

    /**
     * 根据工单ID获取评价
     *
     * @param workOrderId 工单ID
     * @return 工单评价
     */
    CoreWorkOrderEvaluationDO getEvaluationByWorkOrderId(Long workOrderId);

    /**
     * 商家回复评价
     *
     * @param id 评价编号
     * @param reply 回复内容
     */
    void merchantReply(Long id, String reply);

    /**
     * 标记评价为已读
     *
     * @param id 评价编号
     */
    void markAsRead(Long id);

    /**
     * 批量标记评价为已读
     *
     * @param ids 评价编号列表
     */
    void batchMarkAsRead(List<Long> ids);

    /**
     * 根据发起人ID获取评价列表
     *
     * @param initiatorId 发起人ID
     * @return 评价列表
     */
    List<CoreWorkOrderEvaluationDO> getEvaluationListByInitiatorId(Long initiatorId);

    /**
     * 根据接单人ID获取评价列表
     *
     * @param assigneeId 接单人ID
     * @return 评价列表
     */
    List<CoreWorkOrderEvaluationDO> getEvaluationListByAssigneeId(Long assigneeId);

    /**
     * 获取未读评价列表
     *
     * @return 未读评价列表
     */
    List<CoreWorkOrderEvaluationDO> getUnreadEvaluations();

    /**
     * 获取接单人未读评价列表
     *
     * @param assigneeId 接单人ID
     * @return 未读评价列表
     */
    List<CoreWorkOrderEvaluationDO> getUnreadEvaluationsByAssigneeId(Long assigneeId);

    /**
     * 获取评价统计信息
     *
     * @param assigneeId 接单人ID，可为null获取全局统计
     * @return 评价统计信息
     */
    Map<String, Object> getEvaluationStatistics(Long assigneeId);

    /**
     * 计算平均评分
     *
     * @param assigneeId 接单人ID，可为null获取全局平均分
     * @return 平均评分
     */
    Double getAverageScore(Long assigneeId);

    /**
     * 导出评价数据
     *
     * @param pageReqVO 查询条件
     * @return 导出数据
     */
    List<CoreWorkOrderEvaluationDO> getEvaluationList(CoreWorkOrderEvaluationPageReqVO pageReqVO);

}